home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / UTILREEN / SCRENCAP.LZH / GEMCAP.ARC / GEMCAP.DOC < prev    next >
Text File  |  1989-10-15  |  12KB  |  289 lines
  1.  
  2.  
  3.  
  4.                                    Natural Software
  5.                                 19 South Fifth Street
  6.                                 St. Charles, IL 60174
  7.                                     (312) 377-7320
  8.  
  9.                     _______
  10.                ____|__     |               (tm)
  11.             --|       |    |-------------------
  12.               |   ____|__  |  Association of
  13.               |  |       |_|  Shareware
  14.               |__|   o   |    Professionals
  15.             -----|   |   |---------------------
  16.                  |___|___|    MEMBER
  17.  
  18.  
  19.           This program is produced by a member of the Association of 
  20.           Shareware Professionals (ASP).  ASP wants to make sure that
  21.           the shareware principle works for you. If you are unable to
  22.           resolve a shareware-related problem with an ASP member by 
  23.           contacting the member directly, ASP may be able to help. The
  24.           ASP Ombudsman can help you resolve a dispute or problem with
  25.           an ASP member, but does not provide technical support for 
  26.           members' products. Please write to the ASP Ombudsman at 
  27.           P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
  28.           message via easyplex to ASP Ombudsman 70007,3536
  29.  
  30.  
  31.  
  32.  
  33.           This share ware utility program: GEMCAP.COM, allows you to
  34.           capture screen images from other programs, save them in separate
  35.           GEM .IMG files, and later load them into other programs that can
  36.           read the same .IMG format such as Ventura Publisher and
  37.           WordPerfect version 5.0. 
  38.  
  39.           !!! Note !!!: GEMCAP.COM works with IBM CGA (color) text and
  40.           graphics modes. It will work on monochrome systems and Hercules
  41.           in text mode only. It will not work on Hercules displays in
  42.           graphics mode. GEMCAP works with EGA and VGA display adapters in
  43.           text modes and 640 x 200 graphics mode only! If the program you
  44.           wish to capture screens from uses a bitmapped display with EGA or
  45.           VGA, it probably uses a higher resolution. If this is the case,
  46.           to use GEMCAP you must reconfigure that program to use CGA
  47.           graphics mode (usually you must run through the installation
  48.           process and tell it that your display type is CGA 640 x 200).
  49.  
  50.           This version (3.0) of GEMCAP automatically adjusts for monochrome
  51.           and Hercules adapters. Earlier versions used a separate program
  52.           (GCMONO.COM) for these display types.
  53.  
  54.           GEMCAP is a Terminate and Stay Resident (TSR) program. When you
  55.           run it from the DOS command line, it will announce its presence
  56.           and quietly sink into the background and wait to be called into
  57.           action (when its "hot key" is pressed). When you run GEMCAP, you
  58.           must provide it with the location and starting file name to use
  59.           to store the screen images it captures. For example, you might
  60.           start GEMCAP with this command:
  61.  
  62.                          GEMCAP C:\SCREENS\SCREENA.IMG
  63.  
  64.           Now GEMCAP will store its screens in the SCREENS sub-directory.
  65.           Note that the SCREENS sub-directory must already exist. The first
  66.           screen it saves will be called SCREENA.IMG, the second will be
  67.           called SCREENB.IMG. Each subsequent .IMG file will increment the
  68.           character in the filename just before the extension. These files
  69.           are graphic bit image files compatible with any program that
  70.           reads GEM .IMG files, regardless of whether the original screen
  71.           was in text mode or graphics mode.
  72.  
  73.           To activate GEMCAP and save the current screen to a .IMG file,
  74.           you press the [Alt + .] keys (that's the period key and the Alt
  75.           key) together. You will hear a beep when GEMCAP is called. Three
  76.           beeps means it successfully wrote an .IMG file to the specified
  77.           directory. Only one beep means it was unable to create the file
  78.           (could not find the directory?). Only two beeps means it created
  79.           the file, but could not write the full 16k screen buffer, (disk
  80.           full?).
  81.  
  82.           GEMCAP will detect the current video mode and adjust. It converts
  83.           text mode screens into bit mapped graphics.
  84.  
  85.           Like any other TSR, GEMCAP may have compatibility problems with
  86.           other software, especially other TSR's. If you have trouble, try
  87.           installing GEMCAP by itself and adding your other TSR utilities
  88.           one at a time after you get GEMCAP to work.
  89.  
  90.  
  91.           New for version 3.0:
  92.           --------------------
  93.  
  94.           GEMCAP converts reverse video areas of the screen appropriately.
  95.           Any color attribute combination that results in darker characters
  96.           with a lighter background will be converted to reverse video. The
  97.           following color attribute combinations on the captured screen
  98.           will result in reverse video:
  99.  
  100.                     any of these background       With these foreground
  101.                     -----------------------       ---------------------
  102.                     green                         black     grey
  103.                     cyan                          blue      lt blue
  104.                     brown                         red       lt red
  105.                     white                         magenta   lt magenta
  106.  
  107.  
  108.           If you wish to reverse the entire screen, for example from white
  109.           on black to black on white, load GEMCAP with the following
  110.           command line argument (-R) as shown below:
  111.  
  112.                          GEMCAP -R C:\SCREENS\SCREENA.IMG
  113.  
  114.  
  115.           New for version 3.1:
  116.           --------------------
  117.  
  118.           GEMCAP now will capture EGA text mode screens with 43 lines and
  119.           VGA text mode screens with 50 lines. You must decide which mode
  120.           you want when you load GEMCAP via one of the following command
  121.           line arguments: (-E) for EGA 43 line mode, and (-V) for VGA 50
  122.           line mode. For example, the command:
  123.  
  124.                          GEMCAP -E C:\SCREENS\SCREENA.IMG
  125.  
  126.           loads GEMCAP set for EGA 43 line mode. Note that when you load
  127.           GEMCAP in this way, you cannot also capture graphics mode
  128.           screens. You must re-boot to unload, then re-load GEMCAP normally
  129.           for graphics screens.
  130.  
  131.  
  132.           Different sized images:
  133.           -----------------------
  134.  
  135.           Note that with Ventura Publisher or WordPerfect 5.0, the size of
  136.           the image when incorporated into your document is dependent on
  137.           the size of the frame (VP) or figure (WP). For best results, you
  138.           must adjust this size (within VP or WP) so that pixels are not
  139.           truncated or compressed. Alternatively, you can change the size
  140.           characteristics within the IMG file itself.
  141.  
  142.           The size of the captured image is controlled by two words in the
  143.           .IMG file. These are constants in the GEMCAP program. However if
  144.           you wish to adjust this size, you can experiment with different
  145.           values (that is if you really want to tinker around with debug).
  146.           The first word specifies the pixel size in width, the second word
  147.           specifies the pixel size in height (unit of measure is in
  148.           microns). The default values are: (in hexadecimal):
  149.  
  150.                          Address        Value
  151.                          0108           00D5 (width)
  152.                          010A           01AA (height)
  153.  
  154.  
  155.           To make the displayed image one half the size of the default,
  156.           change these values to:
  157.  
  158.                          Address        Value
  159.                          0108           006A (width)
  160.                          010A           00D5 (height)
  161.  
  162.           The steps using Debug to do this are: (you enter the keystrokes
  163.           marked ^^)
  164.  
  165.                DEBUG SCREENA.IMG             (Load the image file)
  166.                ^^^^^^^^^^^^^^^^^
  167.  
  168.                E 0108                        (Enter data at address 0108)
  169.                ^^^^^^
  170.                XXXX:0108 00.00 D5.6A         (change 00D5 to 006A,          
  171.                             ^^    ^^          space bar between entries)
  172.  
  173.                E 010A                        (do the same for address 010A)
  174.                ^^^^^^
  175.                XXXX:010A 01.00 AA.D5         (change 01AA to 00D5)
  176.                             ^^    ^^
  177.  
  178.                W                             (write the changes to the      
  179.                ^                              file)
  180.                Writing 4020 bytes
  181.  
  182.                Q                             (return to DOS)
  183.                ^
  184.  
  185.  
  186.  
  187.           You can experiment with other values. However, some combinations
  188.           will cause truncations of pixels when the image is displayed.
  189.  
  190.           If you find a set of values that work for your application and
  191.           wish to make them the default values for all captured images,
  192.           change the corresponding values in the program (GEMCAP.COM)
  193.           itself. These values are at location 095E and 0960 (hex) when
  194.           GEMCAP is loaded into Debug. (These locations may be different in
  195.           other versions of GEMCAP).
  196.  
  197.  
  198.  
  199.           ShareWare:
  200.           ----------
  201.  
  202.           The GEMCAP package is being distributed as shareware. This means
  203.           that it is not free. This means that you must pay to use it.
  204.           However, you do not have to pay to try it, test it, and to
  205.           determine if it is going to be useful to you. You are probably
  206.           familiar with the concept by now. ShareWare programs give you the
  207.           advantage of "test driving" them. The advantage to the developer
  208.           is a relatively inexpensive distribution method. For this concept
  209.           to work and keep working for our mutual advantage, you really
  210.           must register and pay for the software you actually find useful.
  211.  
  212.           Please feel free to pass along a copy of this disk to others for
  213.           their trial use. But please distribute it in its original
  214.           unaltered state. The compressed arc file: GEMCAP.ARC is intended
  215.           for uploading to your local bulletin boards.
  216.  
  217.           To register your use of GEMCAP, send $20.00 to Natural Software
  218.           at the address above. This entitles you to one upgrade to the
  219.           next new release for free (please specify the version you
  220.           currently have when registering). We will also send you a
  221.           description of our other software offerings (including PC-Draft
  222.           II which allow you to edit and enhance your captured images) and
  223.           provide free telephone support as needed.
  224.  
  225.           If you have suggestions for improvement, or problems please write
  226.           or call.
  227.  
  228.  
  229.  
  230.            
  231.                             Gemcap Registration/Order form 
  232.                             ------------------------------
  233.                                        
  234.            
  235.           Please register ______ copies of GEMCAP.COM: 
  236.  
  237.           version I have: _3.2__
  238.            
  239.  
  240.           Name:___________________________________________________________ 
  241.  
  242.  
  243.           Company:________________________________________________________
  244.  
  245.  
  246.           Address:________________________________________________________
  247.  
  248.  
  249.           City:________________________________ State:____ Zip:____________
  250.  
  251.  
  252.           Telephone: (______) ______-__________ 
  253.  
  254.  
  255.           Payment of $_____________: [ ] check enclosed   [ ] VISA   [ ] MC
  256.  
  257.            
  258.           card #:_____________________________________ Exp. Date:__________
  259.  
  260.  
  261.           Mail to:
  262.                                   Natural Software 
  263.                                 19 South 5th. Street 
  264.                              St. Charles, Illinois 60174 
  265.  
  266.           For quantity discounts and site license information call: 
  267.            
  268.                                    (312) 377-7320 
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.